home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / musik / dtl / readme.install < prev   
Text File  |  1995-03-09  |  5KB  |  121 lines
  1.  
  2.                   INSTALLING THE DES-TRACKER LIBRARY SYSTEM
  3.                   =========================================
  4.  
  5.                           Written by Darren Schebek
  6.                               December 18, 1993
  7.  
  8.          destracker.library, LScope, DTC, mJuke, and MODInfo are all
  9.                     designed and written by Darren Schebek
  10.                     Copyright ©1992,1993 by Darren Schebek
  11.                              All rights reserved
  12.  
  13.  
  14.  
  15. In order to install the DES-Tracker library system, you must do the
  16. following things:
  17.  
  18.  
  19.     1) copy the file "destracker.library" to your LIBS: directory.
  20.  
  21.     2) copy the file "DTC" to your c: or other command directory (like
  22.        bin:, for example).
  23.  
  24.     3) copy the file "LScope" to your c: or other command directory.  This
  25.        is optional.  You don't need LScope in order to use the library. It's
  26.        just an example program.  However, it's a good idea to have it running
  27.        because it will keep the library open if noone else is using it.
  28.  
  29.     4) copy the file "mJuke" to your c: or other command directory.  This is
  30.        optional.  mJuke is a simple jukebox program that runs from the command
  31.        line.  If you intend to use it, then you should do this step.
  32.  
  33.     5) You may optionally copy the "MODInfo" program into your "c:" or command
  34.        directory.  MODInfo display statistics about a song file.
  35.  
  36.     6) If you intend to use the ARexx features of the DES-Tracker library,
  37.        then you must have the following lines in your startup-sequence:
  38.  
  39.             rxlib rexxmathlib.library 5 -30 0
  40.             rxlib rexxsupport.library -5 -30 0
  41.             rxlib destracker.library -5 30 0
  42.  
  43.        It goes without saying that you'll require the above rexx libraries to
  44.        go with each "rxlib" invocation above (if you're going to use ARexx,
  45.        that is).  Also, if you wish to use the Play.rexx program, you should
  46.        also have the following line:
  47.  
  48.             rxlib req.library -5 -60 2
  49.  
  50.        You don't need req.library if you don't use Play.rexx.  Of course, you
  51.        could always write your own play program just the way you like it.  :)
  52.  
  53.  
  54.     That's it.  The first thing you should do is run the LScope program,
  55. and then try loading up a song (Noisetracker v2.0, Protracker v1.1a and up,
  56. or Soundtracker v2.6 formats only for this library version) using the DTC
  57. program, which involves getting to a command line window and typing:
  58.  
  59.         dtc LP {songname}
  60.  
  61. There you go.  you can also type just "dtc" to get a list of the commands
  62. that DTC supports (by the way, "LP" means "Load and Play module").
  63.  
  64.  
  65.  
  66.  
  67.         I DON'T PROGRAM! I DON'T USE AREXX! I JUST WANT TO PLAY TUNES!
  68.         ==============================================================
  69.  
  70.     If you just want to know how to load and play tunes from the CLI without
  71. having to plow through reams of documentation, then I'll tell you:
  72.  
  73.     1) Copy the file "destracker.library" to your "libs:" directory.
  74.  
  75.     2) Copy the file "DTC" to your command directory (e.g. c:, bin:).
  76.  
  77.     3) At a command line prompt, type the following to load a tracker module
  78.        into the library:
  79.  
  80.             DTC LP {songname}
  81.  
  82.        ...where {songname} is the filename (including path if song is not in
  83.        current directory) of the song you wish to load.  Don't forget to press
  84.        the return key at the end (ha ha, I know you won't).  Remember that the
  85.        song must be in Noisetracker v2.0, Soundtracker v2.6, Protracker v1.1a
  86.        format & up, or DES-Tracker v1.0 format for DESTracker to be able to
  87.        load and play the song.
  88.  
  89.     That's it.
  90.  
  91.  
  92.     Also remember that you can optionally run the included LScope program for
  93. a nifty visual treat while the song is playing.  LScope also serves another
  94. purpose by having it running all the time.  As long as it is running it will
  95. prevent the library from being flushed by other applications (like DPaint,
  96. Grrr!).  But essentially, LScope is just an example of a program that uses the
  97. library.  If you don't like LScope, or the included jukebox program example,
  98. well, then you can write your own.  It's easy! (Well, I had fun, anyway :).
  99.  
  100.     Now you should proceed to the DTLib.ReadMe file in the "DTL" directory if
  101. you haven't already read it.  Lot's o' features, files, and assembly source
  102. code examples!
  103.  
  104.     Also, don't forget to check out the History.TXT file to see what new and
  105. wonderful things have been added for this release!
  106.  
  107.  
  108.                                          - Darren Schebek, December 18, 1993
  109.  
  110.  
  111. You can write to me here:       or contact me on usenet at:
  112.  
  113.     Darren Schebek                  dschebek@outb.wimsey.bc.ca
  114.     5620 Sherwood Blvd.
  115.     Delta, B.C.                 or call Wizard Online (my hangout):
  116.     CANADA
  117.     V4L-2C5                     (604)322-3266 (2400 baud) or
  118.                                 (604)322-3232 (2400 baud) or
  119.                                 (604)322-3972 (14.4K baud)
  120.                                 (Sysop is Roger Earl)
  121.